home *** CD-ROM | disk | FTP | other *** search
/ SGI Performance Co-Pilot 1.3 / SGI Performance Co-Pilot 1.3.iso / dist / pcp.idb / usr / share / catman / u_man / cat3 / PMAPI / pmnameid.z.z / pmnameid.z / pmnameid
Text File  |  1997-04-03  |  3KB  |  67 lines
  1.  
  2.  
  3.  
  4. PPPPMMMMNNNNAAAAMMMMEEEEIIIIDDDD((((3333))))                                                        PPPPMMMMNNNNAAAAMMMMEEEEIIIIDDDD((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmNNNNaaaammmmeeeeIIIIDDDD - translate a PMID to a performance metric name
  10.  
  11. CCCC SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ppppccccpppp////ppppmmmmaaaappppiiii....hhhh>>>>
  13.  
  14.      iiiinnnntttt ppppmmmmNNNNaaaammmmeeeeIIIIDDDD((((ppppmmmmIIIIDDDD ppppmmmmiiiidddd,,,, cccchhhhaaaarrrr ********nnnnaaaammmmeeee))))
  15.  
  16.      cccccccc ............ ----llllppppccccpppp
  17.  
  18. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.      Given a Performance Metric ID (PMID) via _p_m_i_d, ppppmmmmNNNNaaaammmmeeeeIIIIDDDD will determine
  20.      the corresponding metric name, if any, in the Performance Metrics Name
  21.      Space (PMNS), and return this via _n_a_m_e.
  22.  
  23.      If the PMNS contains multiple names associated with the requested PMID,
  24.      one of these will be returned via _n_a_m_e, but there is no way to determine
  25.      which of the duplicate names this will be.  See ppppmmmmNNNNaaaammmmeeeeAAAAllllllll if all
  26.      corresponding names are required.
  27.  
  28.      _n_a_m_e is a null-byte terminated string, allocated by ppppmmmmNNNNaaaammmmeeeeIIIIDDDD using
  29.      mmmmaaaalllllllloooocccc(3C) and it is the caller's responsibility to call ffffrrrreeeeeeee(3C) to
  30.      release the storage when the value is no longer required.
  31.  
  32.      In the absence of errors, ppppmmmmNNNNaaaammmmeeeeIIIIDDDD returns zero.
  33.  
  34. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  35.      PPPPMMMMAAAAPPPPIIII(3), ppppmmmmGGGGeeeettttCCCChhhhiiiillllddddrrrreeeennnn(3), ppppmmmmLLLLooooaaaaddddAAAASSSSCCCCIIIIIIIINNNNaaaammmmeeeeSSSSppppaaaacccceeee(3), ppppmmmmLLLLooooaaaaddddNNNNaaaammmmeeeeSSSSppppaaaacccceeee(3),
  36.      ppppmmmmLLLLooooooookkkkuuuuppppNNNNaaaammmmeeee(3), ppppmmmmNNNNaaaammmmeeeeAAAAllllllll(3) and ppppmmmmnnnnssss(4).
  37.  
  38. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  39.      PPPPMMMM____EEEERRRRRRRR____NNNNOOOOPPPPMMMMNNNNSSSS
  40.           A PMNS must have been loaded with ppppmmmmLLLLooooaaaaddddAAAASSSSCCCCIIIIIIIINNNNaaaammmmeeeeSSSSppppaaaacccceeee(3) or
  41.           ppppmmmmLLLLooooaaaaddddNNNNaaaammmmeeeeSSSSppppaaaacccceeee(3) before calling ppppmmmmNNNNaaaammmmeeeeIIIIDDDD.
  42.  
  43.      PPPPMMMM____EEEERRRRRRRR____PPPPMMMMIIIIDDDD
  44.           _p_m_i_d does not correspond to a defined PMID in the PMNS.
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.